home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmActivateProtocol.z / XmActivateProtocol
Encoding:
Text File  |  2002-10-03  |  3.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll - A VendorShell function that activates a
  10.           protocol
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Protocols.h>
  14.           vvvvooooiiiidddd XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll(
  15.           WWWWiiiiddddggggeeeetttt sssshhhheeeellllllll,
  16.           AAAAttttoooommmm pppprrrrooooppppeeeerrrrttttyyyy,
  17.           AAAAttttoooommmm pppprrrroooottttooooccccoooollll);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll activates a protocol. It updates the
  24.           handlers and the _p_r_o_p_e_r_t_y if the _s_h_e_l_l is realized. It is
  25.           sometimes useful to allow a protocol's state information
  26.           (callback lists, and so on) to persist, even though the
  27.           client may choose to temporarily resign from the
  28.           interaction. This is supported by allowing a _p_r_o_t_o_c_o_l to be
  29.           in one of two states: active or inactive. If the _p_r_o_t_o_c_o_l is
  30.           active and the _s_h_e_l_l is realized, the _p_r_o_p_e_r_t_y contains the
  31.           _p_r_o_t_o_c_o_l AAAAttttoooommmm.  If the _p_r_o_t_o_c_o_l is inactive, the AAAAttttoooommmm is not
  32.           present in the _p_r_o_p_e_r_t_y.
  33.  
  34.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll is a convenience interface.  It calls
  35.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollllwith the property value set to the atom
  36.           returned by interning WWWWMMMM____PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLLSSSS.
  37.  
  38.           _s_h_e_l_l     Specifies the widget with which the protocol
  39.                     property is associated
  40.  
  41.           _p_r_o_p_e_r_t_y  Specifies the protocol property
  42.  
  43.           _p_r_o_t_o_c_o_l  Specifies the protocol AAAAttttoooommmm
  44.  
  45.           For a complete definition of VendorShell and its associated
  46.           resources, see VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3).
  47.  
  48.      RRRREEEELLLLAAAATTTTEEEEDDDD
  49.           VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3), XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll(3),
  50.           XXXXmmmmRRRReeeemmmmoooovvvveeeePPPPrrrroooottttooooccccoooollllssss(3) and XXXXmmmmIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm(3).
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.